// 《围棋》作者版权所有。版权所有。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// go:build darwin |蜻蜓| freebsd | linux | netbsd | openbsd 
// +build darwin dragonfly freebsd linux netbsd openbsd 

package base

import (
	"os"
	"reflect"
	"syscall"
	"unsafe"
)

// TODO（mdempsky）：是否有一个更高级别的抽象仍然
// 对iimport有效？

// mapFile以字符串形式返回文件中从
// 指定偏移量开始的长度字节。
func MapFile(f *os.File, offset, length int64) (string, error) {
	// POSIX mmap：“实现可能需要off是页面大小的倍数。”
	x := offset & int64(os.Getpagesize()-1)
	offset -= x
	length += x

	buf, err := syscall.Mmap(int(f.Fd()), offset, int(length), syscall.PROT_READ, syscall.MAP_SHARED)
	keepAlive(f)
	if err != nil {
		return "", err
	}

	buf = buf[x:]
	pSlice := (*reflect.SliceHeader)(unsafe.Pointer(&buf))

	var res string
	pString := (*reflect.StringHeader)(unsafe.Pointer(&res))

	pString.Data = pSlice.Data
	pString.Len = pSlice.Len

	return res, nil
}

// keepAlive是运行时的重新实现。KeepAlive，它在Go 1.7之前没有添加，而我们需要用Go 1.4编译。
var keepAlive = func(interface{}) {}
